*Mental Calculation* (Calcul mental en français) est un simple outil fait pour pratiquer l'*anzan* - le calcul mental effectué en visualisant un soroban (boulier japonais).

http://en.wikipedia.org/wiki/Soroban

Dépendances:
============

pour la version Windows
------------------------
Toutes les dépendances sont incluses sauf espeak pour la synthèse vocale

pour la version *source*
------------------------
- python 2.6 (ou plus récent)
- PyQt4 4.7 (ou plus récent)
- qt 4.6 + phonon (ou plus récent)
- espeak pour la synthèse vocale (en option)

Téléchargements:
================

Python
  http://www.python.org/download
Qt
  http://qt.nokia.com/downloads/downloads#qt-lib
PyQt
  http://www.riverbankcomputing.co.uk/software/pyqt/download
eSpeak
  http://espeak.sourceforge.net/download.html

Espeak
======

*mentalcalculation* recherche *espeak* dans plusieurs endroits
    - C:\Program Files\eSpeak\command_line\espeak.exe sur Windows
    - /usr/bin/espeak sur Linux

Seulement si *espeak* est trouvé, la fonction de synthèse vocale sera disponible.

Si, pour quelques raisons que ce soit, espeak est installé à un endroit différent, vous pouvez le spécifier grâce au fichier de configuration. Voir plus bas.

*Espeak* utilisera la langue de votre locale par défaut.
Vous pouvez changer ça dans le fichier de configuration, section [Espeak]

Fichier de configuration
------------------------
*mentalcalculation* sauve ses préférences dans un fichier:
Sur Linux ou tout Unix-like
  ~/.config/mentalcalculation/mentalcalculation.ini
Sur Windows
  C:\Documents and Settings\<votre_nom_d_utilisateur>\Application Data\mentalcalculation\mentalcalculation.ini pour Windows XP
  ou
  C:\Users\<votre_nom_d_utilisateur>\AppData\Roaming\mentalcalculation\mentalcalculation.ini pour Windows Vista ou au dessus

Il vous faudra peut-être modifier les options de l'explorateur Windows pour pouvoir voir les fichiers et répertoires cachés et accéder au fichier de configuration.

Vous devez lancer au moins une fois *mentalcalculation* (et le fermer) pour que ce fichier soit créer.

Note: Aucune modification n'est faite au registre de Windows.

Personalisation
===============
Le fichier de configuration ressebmel à ça:

    ; les commentaires sont supprimés automatiquement
    [General]
    digits=1
    rows=5
    timeout=1500
    flash=500
    hands_free=false
    neg=false
    no_plus_sign=false

    [GUI]
    fullscreen=false
    font_color=#000000
    background_color=transparent

    [Espeak]
    cmd=C:\\Program Files\\eSpeak\\command_line\\espeak.exe
    lang=en
    speed=170 ; mot par minute de 80 à 390

    [Sound]
    one_digit=false
    speech=false
    annoying_sound=false

Couleurs
++++++++
Vous pouvez changer la couleur de l'arrière-plan ou de la police dans la section [GUI]. Midifiez font_color et/ou background_color; ils doivent des codes HTML valides ou des couleurs explicites: voir http://doc.qt.nokia.com/latest/qcolor.html#setNamedColor pour plus de détails
Vous pouvez vous aider de http://www.colorpicker.com/ par exempel pour choisir une couleur. Ou encore http://html-color-codes.info/. Une recherche dans vore moteur de recherche préféré peut vous fournir un logiciel précis si voulu.

Polices
+++++++
On peut modifier la police de caractères des nombres. Il faut ajouter une directive font dans la section [GUI], en spécifiant une famille de police. Par exemple:

    font=Times New Roman

Son
+++
Changer la variable annoying_sound dans la section [Sound] à true pour avoir un son à chaque fois qu'un nombre est affiché à l'écran.

Le son n'est joué que si la synthèse vocale n'est pas selectionnée.

Par défaut, le fichier s'appelle annoying-sound.mp3 dans le répertoire sound du dossier d'installation de *mentalcalculation*. Vous pouvez changer ce dichier pour n'importe quel son, de préférence court.

Signe plus
++++++++++
On peut suppriemr l'affichage du signe plus devant les nimbres quand on a choisi d'avoir des soustractions

    noplussign=true

dans la section [General]

Statistiques
++++++++++++
Avec la version 0.3.5, chaque fois que vous lancez *mentalcalculation*, il essaye de se connecter à www.sorobanexam.org/mentalcalculation?ping=UUID. L'UUID est un uuid v4 crée aléatoirement. Aucune information n'est envoyée. Cela permet de générer des statistiques sur l'usage de ce soft. et de savoir si les personnes le téléchargent une fois sans jamais l'utiliser ensuite ou si il est réellement utiliser souvent.

Vous pouvez ne pas apprécier ceci, et vous pouvez le donc désactiver. Dans mentalcalculation.ini, ajouter une ligne

    uuid=opt-out

dans la section [General]; vous pouvez aussi utiliser les valeurs: no, No, none, None, false, False, optout ou la laisser vide.

Ou remplacez la valeur existante, si la ligne est déjà présente, par une des valeurs citées plus haut.

Ceci devrait normalement être supprimé à la prochaine version.

Résilience
==========
Si vous n'aimez pas les émoticons ou les sons vous pouvez les renommer/effacer de votre disque dur et *mentalcalculation* fera très bien sans !


Remerciements
=============
Je dois remercier le projet Tango pour les icones que j'ai emprunté et le projet GNOME (gnome-audio gnome-media) pour les fichiers sons que j'utilise.

Merci à burlie (@Flickr) pour l'image du soroban. Voir http://www.flickr.com/photos/burls/

vim: set ft=rst:
